home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / comm / htasc30.zip / HTASC.DOC < prev    next >
Text File  |  1996-06-14  |  7KB  |  132 lines
  1.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  2.                HTASC -- An .HTM to .ASC Document Converter
  3.  =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  4.  
  5.   HTASC copyright 1995, 1996 Charles Dittell and Suncoast Software Systems
  6.                              Version 3.0
  7.  
  8. INTRODUCTION: HTASC takes WorldWideWeb ("HTML") documents (available
  9.  through WWW on the Internet), and converts them to "raw" ASCII files.
  10.  (HTML stands for HyperText Markup Language, and are usually called
  11.  "Web Pages." An HTML document's extension is usually ".htm" (on 
  12.  DOS-based PCs). The ASCII file will have an ".asc" extension.
  13.  
  14. SHAREWARE/WARRANTY: HTASC is marketed as shareware, which is a commercial
  15.  form of distributing software. You are free to use HTASC for up to four
  16.  weeks. After that, you must either register HTASC or delete it from your
  17.  computer. The shareware concept helps keep prices very low, and supports
  18.  many individual programmers. Registration eliminates the stupid sounds and
  19.  three second delay in HTASC. In addition, registered users can call HTASC
  20.  with no document name, and HTASC will present a list of HTML documents 
  21.  from which you may choose a document to convert. Re warranty, there is
  22.  NO warranty for HTASC, expressed or implied; you use HTASC entirely at
  23.  your own risk (we gotta say that).
  24.  
  25. HARDWARE REQUIREMENTS: A PC, very little memory, very little drive space.
  26.  
  27. INCLUDED FILES:   HTASC.EXE The executable program
  28.                   HTASC.DOC You're reading it
  29.                REGISTER.FRM Registration form: read it, include check, 
  30.                             send it in, earn eternal thanks. NOTE:
  31.                             undergraduate college students may register
  32.                             FOR FREE, but must include their college name
  33.                             and student's college address on the 
  34.                             registration form. College professors and
  35.                             other educational professionals may purchase 
  36.                             multiple licenses for themselves and their
  37.                             students very inexpensively: write or call 
  38.                             for details.
  39.                       H.BAT Sample batch file for optional use with HTASC
  40.                 FILE_ID.DIZ Short description of HTASC
  41.  
  42. HOW TO USE IT: Put HTASC in a pathed directory (such as c:\dos). Call 
  43.  HTASC from the directory where your .htm files exist). I put HTASC.EXE 
  44.  in my (pathed) "utils" directory. Use the following command line 
  45.  convention:
  46.  
  47.                 HTASC filename[.ext]
  48.  
  49.  In other words, type "htasc" and then the filename (with .htm extension
  50.  optional). If the HTML file is called thispage.htm, to convert it to an
  51.  ascii file, type "htasc thispage" (or "htasc thispage.htm").  HTASC will
  52.  read the file, and output "thispage.asc" (the file's name plus an ".asc"
  53.  extension). The output file will have deleted all HTML codes, and, where
  54.  possible, add a <LF><CR> after 80 or less characters on each line.  "<hr>"
  55.  commands ("hard rule") will produce a line emulating a horizontal line,
  56.  e.g., _________________________ .   Some other HTML extrapolations are
  57.  attempted, such as quotes, "ascii underline" (e.g., it's _important_),
  58.  and the reduction of multiple blank lines.
  59.  
  60.  Obtaining Web pages is easy: for instance, from Netscape Navigator(tm), 
  61.  after you've landed on the page you wish to convert, choose 
  62.  "File"..."Save As," then keep or change the page name and/or 
  63.  drive/directory. After you've left the Web (well, it's possible to use
  64.  HTASC while on the Web, but this is a "basic" example), go to the
  65.  drive/directory where the Web page now resides, and (assuming HTASC.EXE
  66.  is in a pathed directory), call HTASC (as shown below).
  67.  
  68.                 HTASC filename[.ext]
  69.  
  70.  HTASC works fine in a batch file; errors will not "freeze" the HTASC
  71.  program. This feature should be helpful to BBS SysOps who may want
  72.  to automatically convert HTML documents to ASCII files for viewing on
  73.  their BBSs. Enclosed is a sample batch file which can be used from the
  74.  command line or another batch file. The command structure is simply:
  75.  H filename (or h filename -- caps not necessary); this line can be
  76.  manually typed or inserted in a batch file. If in a batch file, it may
  77.  be necessary to use the "call" command to ensure that control goes back
  78.  to the calling batch file, as: "call h filename". The primary use of this
  79.  batch file is the possibility of calling a number of batchfile commands
  80.  consecutively (adding lines to the h.bat file), such as moving *.htm to the
  81.  processing directory, copying the resulting .asc file to another directory,
  82.  etc.
  83.  
  84. REGISTRATION BENEFITS: The registered version of HTASC enables you to just
  85.  type "HTASC", and a menu of all .htm files in the current directory will
  86.  appear (up to 60 .htm files); you can then type in the .htm number to
  87.  convert that file. I'd also like to give a big "THANKS" to a goodly
  88.  number of registrants: your comments have been very helpful in improving
  89.  HTASC.
  90.  
  91. SUPPORT: Call Suncoast City BBS, 941-953-5505, 1200-28,800 baud, for 
  92.  assistance, before and after registration. Leave message to "Sysop".
  93.  The current version of HTASC and other Suncoast Software Systems programs,
  94.  such as ANSIFILE (ascii file "colorizer"), RSCREEN (BBS intro/exit screen
  95.  rotator), RQUOTE (BBS/PC quotes generator/chooser), and LANCHEK, a 
  96.  Novell Netware(tm) administrator's multi-utility, are available to 
  97.  first-time callers.
  98.  
  99. NOTES: 1 - HTASC has been tested on files up to 316K size (excluding
  100.            links) with no problems whatsoever.
  101.        2 - An easy way to "ANSI-colorize" ASCII files is to use ANSIFILE;
  102.            the newest version is always available on Suncoast City BBS.
  103.            ANSIFILE's command syntax is:
  104.  
  105.          ansifile filename [ansifilename] foregroundcolor [backgroundcolor]
  106.  
  107.        3 - As newer HTML versions occur, it becomes more difficult to
  108.            properly decode the resulting pages. Tables, questionnaires
  109.            and automatically activated features can produce erratic results.
  110.            We'll do our best to get the "best" ascii versions of .htm
  111.            documents possible, but it's always wise to manually "scan" the
  112.            ascii document for stray codes or misalignments.
  113.  
  114. HISTORY:
  115.  06/14/96 Ver 3.0 More minor code sharpening; increased max .htm line length
  116.                   to 900 characters
  117.  06/05/96 Ver 2.8 More minor code sharpening
  118.  06/02/96 Ver 2.7 Minor glitch fixes and code sharpening
  119.  06/01/96 Ver 2.6 Fixed "quotes bug," and extra blank lines problem.
  120.  03/03/96 Ver 2.5 Sharpened code, colors and documentation
  121.  07/05/95 Ver 2.0 Added new conversions, better looking screens; tested up
  122.                   to 316K .htm files with no problem; added some advanced
  123.                   HTML decoding
  124.  07/01/95 Ver 1.7 More minor code tweaking; tested up to 140K files
  125.  06/28/95 Ver 1.6 Better error control, minor code sharpening
  126.  06/15/95 Ver 1.5 Added menu feature to registered version; sharpened screen
  127.  02/20/95 Ver 1.3 Worked hard to add some HTML extrapolations; added .htm 
  128.                   extension name option
  129.  02/19/95 Ver 1.1 Squashed couple of bugs; changed color scheme
  130.  02/18/95 Version 1.0 HTASC released
  131.  
  132.